Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Sequence Grabber Characteristics

SGSetMaximumRecordTime

You can limit the duration of a record operation by calling the SGSetMaximumRecordTime function. You specify the time limit as an exact number of Macintosh system ticks (each is approximately a sixtieth of a second). The most efficient technique for monitoring this time limit is to examine the result code from the SGIdle function, which is described on page 5-36. When the time limit expires, the sequence grabber component sets that result code to grabTimeComplete.

pascal ComponentResult SGSetMaximumRecordTime (SeqGrabComponent s,
                                           unsigned long ticks);

s

Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.

ticks

Specifies the maximum duration for the record operation, in system ticks. Set this parameter to 0 to remove the time limit from the operation.

DESCRIPTION

By default, there is no time limit on a record operation. If you do not set a limit, a record operation will run until it exhausts the Operating System resources or you call the SGStop function (described on page 5-38). Memory and disk space are the two major limiting factors.

You must call the SGSetMaximumRecordTime function before you start the record operation.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help